home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 126-150 / disk_144 / analyticalc / analydocuments.arc / USEREXTS.DOC < prev   
Text File  |  1987-08-25  |  2KB  |  53 lines
  1.     How to Add User Extensions to AnalyCalc
  2.  
  3.     There are 2 subroutines provided with the AnalytiCalc/
  4. PortaCalc package designed to facilitate addition of user defined
  5. commands or functions to the sheet without having to get into the
  6. logic of the spreadsheet otherwise very deeply. These are the
  7. USRCMD.FOR file, for adding user commands, and the USRFCT.* files
  8. for adding user functions.
  9.     Currently supplied:
  10.  
  11.     USRFCT.FTN    Minimal user functions, supports only
  12.             the *U IDATE function to return system
  13.             date.
  14.     USRFCT.FOR    In addition to above supports the *U MTXEQ
  15.             function to solve matrix equations.
  16.     USRFCT.ASC    In addition to above, supports MOVEV
  17.             and MDET (move matrix values, compute
  18.             determinant)
  19.     USRFCT.SRC    In addition supports MPROD, MADDV, MSUBV,
  20.             MMPYT, MMPYC, and VARY functions for more
  21.             general matrix math. Standard on VAX.
  22.  
  23.     USRCMD.FOR    (Only for VAX): no-op at present, but
  24.             is passed the command line and a "command
  25.             found" flag and an indicator it may set
  26.             for type of recalculation to do. The
  27.             ICODE return may be 1 for no recalc,
  28.             3 for default recalc, or 2 to redo
  29.             sheet & redraw. Set the IGOTIT argument
  30.             to 1 if you process the command there.
  31.  
  32.     Various parsing aids are provided and most system data
  33. exists in commons which may be copied from the XQTCMD.FOR source
  34. code. Any command desired may be implemented. The USRCMD
  35. routine is called ahead of all commands except the *, -,
  36. and journaling commands, so may supersede them if need be.
  37.  
  38.  
  39.     The USRFCT function names are stored in an internal array
  40. and always appear as *U name [args] in the cell. This routine is
  41. called from the CMND subroutine. The method of naming functions allows
  42. unlimited use of names.
  43.     Supplied matrix routines access the array holding values of
  44. the spreadsheet. This is the XVBLS array, and subroutines had to be
  45. modified to address it correctly. The main thing is that the
  46. "distance" between successive rows (same column) on the sheet is
  47. now always RRW (in the parameter statements in VKLUGPRM.FTN), rather
  48. than the normal Fortran default of the dimensions. You must alter
  49. your routines accordingly and remember the sheet is stored so that
  50. the rows are the fast-varying elements. (This is also the computational
  51. order to avoid paging the program to death.)
  52.             Glenn Everhart
  53.